(Quick Reference)

displayFlashMessage

Call this method in controllers to set the display message for next request using flash scope.

The view can render this message using the displayMessage tag.

There are two forms of the method:

displayFlashMessage(String msg) - set the message string (or message code) displayFlashMessage(Map args) - set the message arguments (or message code)

When plugins call this method, their "text" value is automatically namespaced with "plugin.<pluginName>." so this effectively forces all usage in plugins to use i18n messages for text - which is a good thing, because it means the application can override the UI text.

The args supported are:

NamePurpose
textThe text of the label, or an i18n code to resolve to use as the text
textArgsOptional arguments to pass when creating the i18n message text
typeOptional message type indicator i.e. 'warning', 'error', 'info', 'debug'

This method stores the message information in flash scope.